home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / comm / net / Sircle.readme < prev    next >
Text File  |  1998-01-05  |  5KB  |  127 lines
  1. Short:    Serlog IRC Log Extractor v1.0 beta
  2. Author:   dwhiting@europa.com  (Dick Whiting)
  3. Uploader: dwhiting@europa.com  (Dick Whiting)
  4. Version:  Serlog IRC Log Extractor v1.0 beta
  5. Type:     comm/net
  6.  
  7.  
  8.                  Copyright ©1997 by Dick Whiting                      
  9.                                                                                 
  10.                                                                                 
  11.   Standard Disclaimer: I wrote it, it works for me, I don't guarantee           
  12.   that it will do anything productive for anyone else, etc. etc. ;-)            
  13.                                                                                 
  14.   HOWEVER, if you do find a use for it: I homeschool my kids and they would     
  15.   love a postcard from where EVER you live. Instant Geography Lesson;)          
  16.                                                                                 
  17.   Postcards:    Dick Whiting                                                    
  18.                 28590 S. Beavercreek Rd.                                        
  19.                 Mulino, Oregon 97042                                            
  20.                 USA                                                             
  21.                                                                                 
  22.   Email:        Dick Whiting <dwhiting@europa.com>                                                                                 
  23.   HomePage:     http://www.europa.com/~dwhiting/
  24.   IRC:          Satyre on Undernet AmigaCafe                                                                
  25.  
  26.                                                                                 
  27. Basics  
  28. ---------
  29.  
  30. This program takes the output of Serlog and extracts IRC logs from it.
  31. The initial output file includes all lines appearing to be IRC related.
  32. Using THIS file, you can then produce reduced logs for ALL channels and
  33. CHAT conversations, select specific channels, or select specific chat 
  34. sessions to separate files. The final session files remove all of the mIRC
  35. color codes, remove duplicate lines, replaces ACTION with nickname, and
  36. does some basic text formatting for readability. When selecting a
  37. specific nickname to extract, the program should handle any nick changes 
  38. that occur during the session.
  39.  
  40. This is a CLI only command so far. The basic template is:
  41.  
  42. Sircle <SL input output [TEMP outfile] | IRC input> [ALL outfile] 
  43.        {CHAN channel-name outfile} {CHAT chat-nick outfile}
  44.          [QUIET]
  45.  
  46. Examples:
  47.  
  48. Create a file from Serlog input containing ALL IRC related lines:
  49.  
  50.    Sircle SL t:slin t:slout
  51.  
  52. Create same file but also create the TEMP file with just the serial I/O
  53. commands removed (can be used to learn about TCP/IP, PPP, etc.)
  54.  
  55.    Sircle SL t:slin t:slout TEMP t:temp
  56.  
  57. Create the IRC full file and reduce it for ALL channels & chats:
  58.  
  59.    Sircle SL t:slin t:slout ALL t:all
  60.  
  61. Same thing, but also create a file for channel #AmigaCafe:
  62.  
  63.    Sircle SL t:slin t:slout ALL t:all CHAN #amigacafe t:amigacafe
  64.  
  65. Now, also extract a file for a chat with Satyre:
  66.  
  67.    Sircle SL t:slin t:slout ALL t:all CHAN #amigacafe t:amigacafe 
  68.           CHAT satyre t:satyre
  69.  
  70. After doing an intitial Serlog extract, you can use the IRC keyword to 
  71. extract the specific pieces from that file. This saves repeating the Serlog
  72. processing each time:
  73.  
  74. Sircle IRC t:slout ALL t:all CHAN #amigacafe t:amigacafe CHAT satyre t:satyre
  75.  
  76.  
  77. Please note that you can specify multiple CHAN and/or CHAT sequences on the same 
  78. invocation:
  79.  
  80. Sircle IRC t:slout CHAT lindy t:lindy CHAT trollman t:troll CHAT saraba t:saraba
  81.  
  82.  
  83. QUIET turns of the processing messages. 
  84.  
  85.  
  86. Requirements  
  87. ---------------
  88.  
  89. You will need from Aminet:
  90.  
  91.    serlog16.lha       dev/debug   Debugging device to monitor serial-IO
  92.  
  93.  
  94. FILES INCLUDED IN THIS ARCHIVE:
  95.  
  96.    Sircle.Readme          - this is it, so far.
  97.    Sircle                 - the program:)           
  98.  
  99.  
  100. v1.0 Beta:
  101.  
  102.       This is my first attempt at C programming. It was meant to be mainly
  103.       a learning experience and is not a completely polished program. 
  104.  
  105.       As a learning experience, it has only been tested with AmIRC connections
  106.       to Undernet. If there are varying formats of messages amongst the 
  107.       different nets, then some lines may not be located or handled correctly.
  108.  
  109.         Note that it will also probably ONLY work with a PPP connection.
  110.  
  111.       Feel free to contact me if you locate any conditions of improper 
  112.       handling or have any suggestions/comments.
  113.  
  114.  
  115. Dick Whiting
  116. December 9, 1997
  117.  
  118.  
  119. ============================= Archive contents =============================
  120.  
  121. Original  Packed Ratio    Date     Time    Name
  122. -------- ------- ----- --------- --------  -------------
  123.    22536   12160 46.0% 09-Dec-97 16:53:52 +Sircle
  124.     4505    1737 61.4% 09-Dec-97 16:43:26 +Sircle.Readme
  125. -------- ------- ----- --------- --------
  126.    27041   13897 48.6% 19-Dec-97 01:00:12   2 files
  127.